What does this PR do?

This updates the generated Node SDK upload path so file parameters can be passed as either the standard File type or the SDK-provided InputFile helper.

Before this change, InputFile.fromPath() eagerly read the whole file into memory before the request was sent. That made large uploads expensive and bypassed the client's chunked upload flow. This PR keeps path-backed files as lazy InputFile sources, lets the Node client detect them in chunkedUpload(), and reads only the active chunk when a file is larger than the configured chunk size.

Implementation details

• Adds Node-specific file parameter typing so generated upload methods accept File | InputFile.
• Handles future array-of-file parameters as (File | InputFile)[] instead of binding only InputFile[] to the array suffix.
• Adds a hasFileParam Twig filter so generated service files import InputFile only when the service has file parameters.
• Reworks templates/node/src/inputFile.ts.twig so InputFile can be backed by:
  • a path, read lazily through fs only when size/slice/materialization is needed;
  • a Uint8Array, ArrayBuffer, or string;
  • a Blob-like object with arrayBuffer() and slice().
• Updates Client.chunkedUpload() to handle both File and InputFile inputs.
• Preserves current master JSON bigint handling in the Node client while resolving merge conflicts.
• Avoids top-level fs/path imports in InputFile, so importing the helper does not immediately break edge-style runtimes. Path-based filesystem methods now throw a clear runtime error when filesystem access is unavailable.
• Updates Node 16/18/20 expected output for the large upload cases.

Example usage

Path-backed uploads now stay lazy and are chunked without loading the full file into memory:

import { Client, Storage, ID } from 'node-appwrite';
import { InputFile } from 'node-appwrite/file';

const client = new Client()
  .setEndpoint('https://cloud.appwrite.io/v1')
  .setProject('<PROJECT_ID>')
  .setKey('<API_KEY>');

const storage = new Storage(client);

await storage.createFile({
  bucketId: '<BUCKET_ID>',
  fileId: ID.unique(),
  file: InputFile.fromPath('./large-video.mp4', 'large-video.mp4'),
  onProgress: (progress) => {
    console.log(`${progress.chunksUploaded}/${progress.chunksTotal}`, progress.progress);
  },
});

Buffer, ArrayBuffer, Uint8Array, string, and Blob-like inputs are also supported:

import { InputFile } from 'node-appwrite/file';

const fromBuffer = InputFile.fromBuffer(await fs.promises.readFile('./avatar.png'), 'avatar.png');
const fromPlainText = InputFile.fromPlainText('hello world', 'hello.txt');
const fromArrayBuffer = InputFile.fromBuffer(await fetch(url).then((res) => res.arrayBuffer()), 'remote.bin');

Existing native File inputs continue to work:

import { File } from 'node-fetch-native-with-agent';

await storage.createFile({
  bucketId: '<BUCKET_ID>',
  fileId: ID.unique(),
  file: new File([new Uint8Array([1, 2, 3])], 'bytes.bin'),
});

Edge-style runtimes can import and use non-filesystem helpers. Filesystem-backed helpers fail only when they are actually used:

const file = InputFile.fromPlainText('edge safe', 'note.txt'); // Works

InputFile.fromPath('./local.txt');
// Throws: File system operations are not supported in edge runtimes. Please use InputFile.fromBuffer instead.

Conflict resolution

This branch was refreshed against current master (d280f89c3). The conflicts were in:

• src/SDK/Language/Node.php
• templates/node/src/client.ts.twig

The Node type override was reduced to only customize file parameters and delegate all other type resolution to Web, so current master type behavior such as int64 and model handling is preserved.

Test Plan

• docker run --rm -v $(pwd):/app -w /app php:8.3-cli php example.php node
• php vendor/bin/phpunit --filter Node20Test
• node -e "globalThis.EdgeRuntime='edge'; const { InputFile } = require('./tests/sdks/node/dist/inputFile.js'); Promise.resolve().then(async () => { const file = InputFile.fromPlainText('hello', 'hello.txt'); const size = await file.size(); if (size !== 5) throw new Error('unexpected size ' + size); try { InputFile.fromPath('/tmp/file.txt'); throw new Error('fromPath did not throw'); } catch (error) { if (!String(error.message).includes('edge runtimes')) throw error; } console.log('edge inputfile smoke:passed'); }).catch((error) => { console.error(error); process.exit(1); });"
• composer lint-twig
• php -l src/SDK/Language/Node.php
• git diff --check

Related PRs and Issues

• Follow-up context from Make InputFile edge-compatible with conditional fs imports #1297 was reviewed. That PR was closed unmerged; this PR folds in a smaller edge-safe filesystem loading approach without the async import race from that patch.

Have you read the Contributing Guidelines on issues?

Yes.